home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / animate.lzh / animate4.doc next >
Text File  |  1987-04-22  |  7KB  |  267 lines
  1. ANIMATE4
  2.  
  3. (c) 1988 by Tom Hudson
  4. Program & Documentation
  5. by Tom Hudson
  6.  
  7. This is a Public Domain utility.
  8.  
  9. ANIMATE4.PRG is the fourth generation
  10. animation display program for the
  11. CYBER family of products:
  12.  
  13. CYBER STUDIO
  14. CYBER CONTROL
  15. CYBER PAINT
  16. CYBER VCR and
  17. CYBER SCUUULPT
  18.  
  19. This program will display delta-file 
  20. AND sequence animations, 
  21. created either by CYBER PAINT in 
  22. .DLT or .SEQ format, or CYBER
  23. STUDIO/CONTROL in .DLT format.  
  24. Delta files (with initial.PI1 files 
  25. and data files with a .DLT extender) 
  26. take up morespace on disk than 
  27. sequence files (composed of only 
  28. file file, which takes up about 
  29. 30-40% less disk space than a 
  30. comparable .PI1/.DLT combination). 
  31. Sequence files take up the same amount
  32. of space in memory as delta files, 
  33. however.  
  34.  
  35. This version of ANIMATE will also 
  36. display all color-palette
  37. changes in .SEQ files created with 
  38. CYBER PAINT 2.0, and no longer
  39. uses the double-buffering command of
  40. the previous animation programs.  
  41. (The buffering is now automatic, and 
  42. very fast.)
  43.  
  44.  
  45. To display .DLT files, click on the 
  46. .DLT button in the custom
  47. file selector.  Likewise, to display 
  48. .SEQ files, click on the .SEQ button.
  49.  
  50. Disk drives may be altered with the 
  51. drive-letter buttons.  Paths
  52. may be moved through with the "Back"
  53. and Reread" buttons.
  54.  
  55. As with my previous animate programs,
  56. there are 2 operating modes:
  57. Batch and manual.  Animations can be 
  58. run in sequence from a hard disk
  59. and/or floppy drives in batch modes, 
  60. with chained animation files
  61. easily accomodated.  NOTE:  You can 
  62. only chain delta files -- 
  63. sequence files are NOT chainable.
  64.  
  65.  
  66. MANUAL MODE
  67.  
  68. The manual mode is invoked by simply 
  69. double-clicking on the
  70. ANIMATE4.PRG icon.  The program will 
  71. display help information
  72. -- take some time to read it for the 
  73. basic commands such as (F)orward, etc.
  74. Click on OK, and you will be presented
  75. with my new file selector.  
  76.  
  77. Loading Delta Files:
  78.  
  79. Select the delta file you want to run
  80. (it can be either stereo or
  81. monoscopic).  The program will load 
  82. the delta file and its associated .PI1
  83. file (L_ and R_ versions, if the 
  84. animation is in stereo).  It will ask 
  85. if you have more delta file sections
  86. (this will only happen if you chained
  87. the animation), click on the 
  88. appropriate button.  If there are more
  89. delta files, the file selector will
  90. reappear, and you must select the name
  91. of the chained delta file.
  92.  
  93. After all delta files are loaded, the 
  94. program will start animation.
  95.  
  96. Loading Sequence Files:
  97.  
  98. Click on the .SEQ button, and the 
  99. sequence files on the disk will
  100. be displayed.  Select the sequence file
  101. you want to run (sequence
  102. files can only be monoscopic).  The 
  103. program will load it and begin running 
  104. automatically.  Press the F key to turn 
  105. Ping-pong mode on or off.
  106.  
  107.  
  108. BATCH MODE
  109.  
  110. The animator program will run in a 
  111. batch mode for continuous
  112. demonstrations of animations.  This is
  113. done through the use of a run
  114. control file, which has the extension 
  115. .RUN.  To work properly, the
  116. ANIMATE4.PRG program must be installed
  117. via the "Install application"
  118. selection on the desktop.  Install 
  119. ANIMATE4.PRG as a GEM application
  120. with document type RUN.
  121.  
  122. To execute the animator in batch mode, 
  123. just double-click on the
  124. appropriate .RUN file.
  125.  
  126. The .RUN file format is discussed after
  127. the keyboard command section.
  128.  
  129.  
  130. KEYBOARD COMMANDS
  131.  
  132. Once you have an animation sequence 
  133. running, the following keys are
  134. operational:
  135.  
  136. F1-F10 -- Control the speed of the 
  137. animation from slow (F1) to fast
  138. (F10).  Default speed is F6.
  139.  
  140. Help -- Aborts the animation and 
  141. displays the file selector for a new
  142. animation in both batch and manual 
  143. modes.  Changes to manual mode if
  144. running in batch mode.
  145.  
  146. Undo -- Quits the program, returning 
  147. to the desktop.
  148.  
  149. F -- Toggles the animation direction 
  150. from forward-only to a forward-reverse
  151. ping-pong effect.  Default is 
  152. forward-only.
  153.  
  154. Space bar -- Pauses and single-steps 
  155. the animation.  Press any other
  156. key to resume normal operation.
  157.  
  158. Alt-L -- Locks the keyboard to prevent
  159. tampering during demonstrations,
  160. no keys will have any effect.  
  161. Press Alt-L again to unlock the 
  162. keyboard.
  163.  
  164.  
  165. .RUN FILE FORMAT
  166.  
  167. The .RUN file is a simple text file, 
  168. which can be created with any text
  169. editor or 1st Word.  Each line has
  170. the following format:
  171.  
  172. PATH,FILE,MORE[,FWDBAK,BUFFER,
  173. SPEED,TIMES]
  174.  
  175. PATH -- Drive and path of animation 
  176. delta file or sequence file, may
  177. be upper or lower case.  Example: 
  178. A:\ANIMATIONS\
  179.  
  180. FILE -- Filename of animation delta 
  181. file, in upper or lower case.
  182. Example: CARGO.DLT.  If it is a 
  183. sequence file, the example would
  184. be CARGO.SEQ.
  185.  
  186. MORE -- Indicates whether or not there
  187. are more delta files to be
  188. chained to this one.  Enter Y if there
  189. are more, or N if there are not.
  190. May be upper or lower case.  If the Y 
  191. is entered, the next line contains the
  192. filename of the next delta file 
  193. in the chain, and the extra parameters 
  194. on this line are not used.  Any number
  195. of files may be chained.  For sequence
  196. files, use an N.
  197.  
  198. FWDBAK -- Indicates whether the 
  199. animation should be run forward only
  200. (F) or forward/reverse (R).  May be 
  201. upper or lower case.  Not used if
  202. the file has more delta files 
  203. chained to it.
  204.  
  205. BUFFER -- This parameter is no longer
  206. used in ANIMATE4.PRG, but should be 
  207. included for compatibility with older
  208. programs. Simply include a B in 
  209. this slot.
  210.  
  211. SPEED -- Indicates the speed at which
  212. the animation should be run.
  213. Values range from 0-9, corresponding
  214. to function keys F1-F10.
  215.  
  216. TIMES -- The number of times the 
  217. animation is to be run before going to
  218. the next animation.  In 
  219. forward/reverse mode, this is the 
  220. number of complete forward/reverse 
  221. cycles; in forward mode, it is the 
  222. number of normal animation cycles.  èA value of 9999 indicates to run the
  223. animation forever, until HELP or UNDO
  224. is pressed.  Use 9999 when you're 
  225. creating a .RUN file that will be 
  226. used to load one animation from a 
  227. floppy disk and display it forever.
  228.  
  229. Example batch files:
  230.  
  231. b:\,cargo.dlt,n,f,b,8,9999
  232.  
  233. Runs the CARGO animation forward at
  234. speed 8, forever.
  235.  
  236.  
  237. c:\animate\,hollow.dlt,y
  238. c:\animate\,hollowb.dlt,n,f,b,9,9999
  239.  
  240. Runs the two-part HOLLOW animation
  241. (HOLLOW.DLT and HOLLOWB.DLT, in the
  242. ANIMATE folder on drive c:) forward
  243. at speed 9, forever.
  244.  
  245.  
  246. a:\,bounce.dlt,n,r,b,7,20
  247. b:\,atari.dlt,y
  248. b:\,atarib.dlt,n,f,b,9,25
  249.  
  250. Runs the BOUNCE animation from drive
  251. A: 20 times in forward/reverse
  252. mode at speed 7, then runs the 
  253. two-part ATARI animation
  254. (ATARI.DLT and ATARIB.DLT) from drive 
  255. B: 25 times at speed 9 forward.  When
  256. the ATARI animation is complete, 
  257. operation resumes with BOUNCE again
  258. and continues until HELP or UNDO 
  259. is pressed.
  260.  
  261. a:\tutorial\,tesla.seq,n,f,b,9,9999
  262.  
  263. Runs the TESLA animation on the CYBER
  264. PAINT disk forward, at speed 9, 
  265. forever (or as long as the hardware 
  266. holds out, whichever comes first).
  267.